home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / misc / bk51f.arj / VSORT.TXT < prev   
Text File  |  1991-12-09  |  5KB  |  118 lines
  1.            VSORT Version 1.0 - Copyright 1989 Roger E. Donais
  2.  
  3. GENERAL:
  4.  
  5. VSORT is a DOS Sort Filter with command line format and options similar
  6. to the DOS Sort utility. The input file is expected to be a carriage
  7. return - line feed delimited ascii text file.  Source lines may be
  8. random length, but cannot exceed 4096 characters. Maximum size of file
  9. is typically limimted to the available disk space.
  10.  
  11. Type VSORT /h to obtain an on-screen command/option summary.
  12.  
  13. When invoked with no parameters, VSORT will simply sort input from the
  14. standard input device (CON) to the standard output device (CON). To
  15. terminate input, press ^Z (Control plus Z) followed by ENTER.
  16.  
  17. The sort will *NOT* be attempted if there is than 48k of memory, and
  18. will abort at the end of the first pass if there is insufficient memory
  19. for the merge buffers. The elapsed time to reach this point will depend
  20. on your disk through-put, which is typically 3% longer than the time it
  21. takes to read and write the file in question using a 25 mHz 486 with a
  22. 680 Meg ESDI Drive reporting a 16ms access and 1012 Meg transfer rate.
  23.  
  24. USAGE:
  25.  
  26.     vsort  <infile  >outfile  [/R] [/+n] [/P<path>]
  27.  
  28.     where  <infile       is a standard DOS redirected input specification.
  29.  
  30.            >outfile      is a standard DOS redirected output specification.
  31.  
  32.            /R            sorts in reverse order (default = ascending)tarting
  33.  
  34.            /+n           sorts starting at column n (default = column 1)
  35.  
  36.            /P<path>      is an optional DOS drive/path specification for
  37.                          the intermediate work file.
  38.  
  39.        NOTE: Vsort uses code page 437 to establish ranking of characters
  40.              and treats upper and lower case letters as equal weight
  41.  
  42.  
  43. EXAMPLE:     vsort <e:\test1.txt >temp.txt /PD:\
  44.  
  45.  
  46. MESSAGES:
  47.  
  48. All runtime messages are written to the stderr device, and will, by
  49. default, be directed to the crt display.
  50.  
  51. When invoked with an /h parameter, VSORT will display a
  52. command-line/option summary.
  53.  
  54. Additional messages that may be displayed are -
  55.  
  56.          ** SORT COMMAND ERROR: **
  57.                  indicates an error was detected in the command line.
  58.                  The command line will be displayed with a carat (^)
  59.                  marking the position where the error was detected.
  60.  
  61.          ** insufficient memory **
  62.                  indicates that there is not enough memory available to
  63.                  provide the necessary merge buffers, or at startup
  64.                  there was less than 48k of memory is available.
  65.  
  66.          ** unable to create intermediate file **
  67.                  indicates an error occurred when VSORT attempted to
  68.                  create the intermediate work file (SORT0000.$$$).
  69.  
  70.          ** intermediate file write error **
  71.                  indicates an error occurred when writing to the
  72.                  intermediate work file.
  73.  
  74.          ** output file write error **
  75.                  indicates an error occurred when writing to the
  76.                  redirected stdout file handle.
  77.  
  78. SYSTEM REQUIREMENTS:
  79.  
  80. This release of VSORT was tested using a 9-Meg file consisting of
  81. 128,000 seventy (70) character carriage-return line-feed delimited
  82. records.  A TSR was used to consume all but 64k of available memory.
  83.  
  84. It is extremely difficult to estimate the resources required to sort a
  85. file of variable length lines. However, a general rule of thumb is that
  86. the available free disk space must be at least twice the size of the
  87. original file. This may exist on two separate drives, but each of the
  88. two drives must have free space at least equal to the size of the
  89. original file.
  90.  
  91. Determing the number of merge blocks, or estimating the memory required
  92. to perform the merge pass is well beyond the scope of this guide.
  93.  
  94. You will know if the existing resources are sufficient to complete the
  95. sort by the end of the first pass. The elapsed time to reach this point
  96. will depend of your disk through-put, and will usually be only 3% longer
  97. than the time it takes to read and write the file in question. The 3%
  98. factor is based upon tests performed using a 25 mHz 486 and the 16ms
  99. access and 1012 Meg transfer provided by a 680 Meg ESDI Drive.
  100.  
  101. -----------------------------------------------------------------------
  102.                         --- The legal Stuff ---
  103.  
  104. VSORT includes trade secrets and confidential information, which is the
  105. copyrighted intellectual property of Roger Donais. 
  106.  
  107. VSORT may be freely copied and distributed on a non-profit basis, but
  108. may not be sold or traded for monetary value, nor used commercially
  109. without the written consent of the author.
  110.  
  111. VSORT is provided without warranty, expressed or implied, including but
  112. not limited to fitfulness for a particular purpose. The author does not
  113. guarantee the accuracy of the program and accepts no responsibility for
  114. its use.
  115.  
  116.                 Roger Donais (Compuserve ID: 70414,524)
  117.  
  118.